home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu325.dms / pu325.adf / LAZi / LAZi.doc < prev    next >
Text File  |  1992-08-04  |  23KB  |  484 lines
  1.  
  2.                    LAZi - A CanDo archive utility interface
  3.                           (Lharc Arc Zoo interface)
  4.                         Version 1.0  created 8/16/91
  5.                                by Mark W. Davis
  6.  
  7.                      Compatible with Arc version     0.23
  8.                                     *Zoo version     2.00
  9.                                      Lharc version   1.30
  10.  
  11.    *When a properly  functioning  port  of Zoo with the "h" option becomes
  12.    available I will incorporate  it  into  LAZi.  The version ported by J.
  13.    Brian Waters does not perform  I/O redirection consistently, if at all.
  14.    If you have one that is  FD and functions properly let me know.  I have
  15.    had a few requests to add support for "LZ".  Should I?
  16.  
  17.    
  18.                                  What it is?
  19.  
  20.    What is LAZi?  LAZi is a graphic interface for  the   archivers  Lharc,
  21.    Arc, and Zoo.    You  supply  the  archive  utilities.   LAZi will add,
  22.    delete, extract, and update single or multiple files;  ;list  and  text
  23.    archives; allow  you  to read extracted readmes/docs or any other ascii
  24.    file;   save a configuration file that holds the locations of your work
  25.    directory(s), archive utilities,  and  icon  position.    Yes,  it will
  26.    iconify and, when re-iconified(?),  stay  where you last placed it!  If
  27.    you have no experience using  Lharc,  Arc,  or  Zoo  I suggest you read
  28.    their documentation before using LAZi.
  29.    
  30.    LAZi was created using CanDo version 1.5 and is  a BOUND CanDo deck and
  31.    does not require CanDo nor the FD program "DeckBrowser" to run.  Due to
  32.    LAZi being a "bound"  deck  (DeckBrowser  built  in) its size is rather
  33.    large.  You should be able to "pack" it using one  of  the  "crunchers"
  34.    available if disk space is a concern.  I haven't  tried  this  but  was
  35.    told that it works.    
  36.  
  37.                           1meg ram is recommended.  
  38.    
  39.  
  40.                                Disclaimer, etc
  41.  
  42.    It hasn't  hung, crashed my machine, munched any of my files, or caused
  43.    ME any problems,  nevertheless...  If you use this program you do so at
  44.    your own risk.   I take no responsibility for any problems that you may
  45.    have while using LAZi.  If you find a problem I can be contacted at the
  46.    address  given  at the end of  this  document.    LAZi  may  be  freely
  47.    distributed  under  the conditions that this textfile  accompanies  the
  48.    program  and that it not be distributed with  any  commercial  software
  49.    without  the  written  consent  of  the  author.    If   you  use  LAZi
  50.    consistently  please  donate  some time and/or money to an organization
  51.    that gives assistance to the homeless.  
  52.  
  53.  
  54.                                  Installation
  55.    
  56.    LAZi  MUST  be  able  to  access  the   following  *CBM*  files  and/or
  57.    directories or results will be unpredictable:
  58.    
  59.    In your PATH - LIST; DELETE; COPY.
  60.    In the FONTS: directory - TOPAZ 8 and TOPAZ 9
  61.    S: must exist to save defaults. (no defaults, no options)
  62.    "RAM DISK:", "RAM:", or an assign (logical) named "RAM:"
  63.    
  64.    The LAZi archive consists of 9 files:
  65.    
  66.    LAZi         - executable for those WITHOUT CanDo v1.5
  67.    LAZi.info
  68.    LAZir        - executable for those WITH CanDo v1.5
  69.    LAZir.info
  70.    LAZiDefaults - unbound requestor deck 
  71.    LAZi.DOC     - this ASCII file
  72.    Cover.pntr
  73.    MHelp.TXT    - ASCII help file for LAZi
  74.    OHelp.TXT    - ASCII help file for LAZi
  75.    
  76.    Place LAZi  or  LAZir(if you own CanDo v1.5), LAZiDefaults, cover.pntr,
  77.    both help files,  and  the  icon  (.info  file)  in the same directory.
  78.    LAZi.DOC may be placed  wherever  you  wish.   You are now ready to use
  79.    LAZi.  You can either double click on its icon or start it from the CLI
  80.    by typing the appropriate executable's name.  Easy, huh?
  81.  
  82.  
  83.  
  84.                             Functional Description
  85.                           
  86.    **Clicking the Right Mouse Button in any window, except  the 'defaults'
  87.    and  LAZiView,  will  reset  the source and destination directories  to
  88.    their current defaults and open the Main Window, if it  is  not already
  89.    opened.
  90.  
  91.  
  92. @ Main Window 
  93.  
  94.    Upon startup LAZi will attempt to load  and display in the list display
  95.    your default source directory.   If no defaults have been saved it will
  96.    display the directory it was started  from  as its source directory and
  97.    "RAM:" as its destination.
  98.  
  99. *** LAZi TITLE/DRAG/STATUS bar
  100.  
  101.    At the top left is your standard 'QUIT' gadget.    Click on it and LAZi
  102.    will go away.  To its right is the TITLE/DRAG/STATUS  bar.  Information
  103.    about  LAZi's current operation, ERROR messages, and brief prompts will
  104.    appear there.    To  the  right  of  the TITLE/DRAG/STATUS bar are your
  105.    standard window to  back/front gadgets.  The leftmost gadget moves LAZi
  106.    behind all other windows  on the Workbench, the rightmost moves LAZi to
  107.    the front.
  108.  
  109. *** SRC:/DST: buttons and string gadgets
  110.  
  111.    Below the TITLE/DRAG/STATUS bar is  a  BUTTON  titled 'SRC:' and to the
  112.    right of that a string gadget.  A single click on the SRC:  button will
  113.    update and load the  current  source  directory  into the list display.
  114.    The string gadget will show the current source directory.  Depending on
  115.    certain actions it may be  blank.  If so, it usually indicates that the
  116.    list  displays  contents  are  the  destination    directory.       The
  117.    TITLE/DRAG/STATUS bar should contain a description.   If  you  click in
  118.    the string gadget, clear out its contents - either by deleting or using
  119.    'AMIGA-X'  -  then enter a VALID pathname (DH0:foobar, DF2:foo/bar/bar,
  120.    FOOBAR:  - an INVALID pathname would be :foobar), that will become your
  121.    current source  directory  for all subsequent operations.  The contents
  122.    of the path  you  enter  will be shown in the list display.  The 'DST:'
  123.    button and string gadget at the bottom of the window will behave in the
  124.    same manner EXCEPT that the  destintion  directory contents will not be
  125.    shown in the list display when  a path is entered in the string gadget.
  126.    A  single  click  on  the  DST:   button  will  place  the  destination
  127.    directory's contents in  the  list  display.  The TITLE/DRAG/STATUS bar
  128.    will indicate that  the listing is the destination directory.  
  129.  
  130. *** Available Memory (stealth button)
  131.  
  132.    Clicking to the right of the Help!  button  (somewhere below the window
  133.    to front gadget) will show the available chip and fast  memory  in  the
  134.    title bar.  
  135.  
  136. *** Iconify!
  137.  
  138.    A single click on this button will iconify LAZi.  LAZi will shrink to a
  139.    115x10  pixel icon located at position 0,0.  When iconified LAZi has  a
  140.    expand  gadget (the quit gadget on the expanded windows) on the left, a
  141.    drag bar  with  the  letters "LAZi" in it, and front/back gadgets.  You
  142.    can drag LAZi  to  a  new  position  by  pointing to the letters "LAZi"
  143.    depressing the left mouse  button  and dragging the icon.  Now whenever
  144.    you iconify LAZi it will  shrink  and position itself at that position.
  145.    You  can  permanently  save  its  iconified  position  by  saving  your
  146.    configuration after setting the icon's position. 
  147.  
  148. *** Directory List Display
  149.  
  150.    The list display will show the contents of either the source directory,
  151.    destination directory,  or  archive.  Listing the source or destination
  152.    directory  was explained  previously.    To  list  the  contents  of  a
  153.    DIRECTORY double click on  the  entry.    This  also  sets your CURRENT
  154.    source to the directory you  entered.  i.e.  if you double clicked down
  155.    a couple of directories then click  on  the  SRC:    button  LAZi  will
  156.    re-read the directory you are currently viewing.    If you want to move
  157.    back  to  your  DEFAULT  source directory click the  RMB  (right  mouse
  158.    button).  If there are more directories each double  click will descend
  159.    into the directory structure.  To ascend the directories, single  click
  160.    on  the  PARENT  button.    Each  click will move you up  to  the  next
  161.    directory level.    The source string gadget will reflect the directory
  162.    path as you move up and down.  Double clicking on an archive entry will
  163.    display a listing of  the  contents  of  that archive.  Directories and
  164.    archives  are  clearly  marked.      LAZi   does  not  like  filenames,
  165.    directories, or archives with "-"s or  spaces in them.  If you use them
  166.    it may not be able to determine  what type of file it is.  As mentioned
  167.    above, clicking the RMB will set and list  the default source directory
  168.    in the list display, and reset the destination.
  169.  
  170.    Double click on  a  filename  to  VIEW  a text file.  The LAZiViewer is
  171.    primitive, just a scroll  bar  and up/down gadgets.  Double (or triple)
  172.    clicking on the up or  down gadget quickly will scroll the text faster.
  173.    If a line is longer than the viewing area click in the viewing area and
  174.    use the cursor keys to navigate.  You can also type in the file you are
  175.    viewing and print it out;  you can't  save  it.    It  has several MENU
  176.    choices;   Iconify will iconify LAZi.  Main will  return  to  the  Main
  177.    window.  Options will take you to the options menu.  Print does what it
  178.    says.  Quit does what it says, quit LAZi.
  179.  
  180. *** FILES buttons
  181.  
  182.    Under the heading of FILES are 3 buttons.  
  183.  
  184.    PARENT will display the  contents  of the parent of the directory shown
  185.    in the SRC:  string gadget and update the string gadget accordingly.  
  186.  
  187.    DEVICES will display your system's logical devices.  Double clicking on
  188.    a device name will open the  root directory of that device and show its
  189.    contents in the list display.  
  190.  
  191.    DEFAULTS will open a requestor that will  allow  you  to enter and save
  192.    your  default  source/destination  directories  and  the paths to  your
  193.    archive utilities.  While the defaults requestor is open you cannot use
  194.    the main window(s).  The pointer will notify you of  this.    You  must
  195.    choose either SAVE, CANCEL, or USE to close the defaults requestor.  If
  196.    you  choose SAVE, the config file will be stored in "S:LAZi.config" and
  197.    the directories you save will be used whenever you start LAZi.  To SAVE
  198.    THE  ICON  POSITION, iconify LAZi and drag the icon to the position you
  199.    desire to save then use the SAVE option in the defaults requestor.  The
  200.    icon position will  not  be saved unless LAZi has been iconified before
  201.    the save.  USE  will  bring  you  back  to  the  main  window using the
  202.    directories you chose in the  defaults  requestor.  CANCEL does what it
  203.    says;  closes the defaults requestor with no action taken.
  204.  
  205. *** ARCHIVES buttons
  206.  
  207.    Selecting PATHNAMES in the main and  options window will add or extract
  208.    the file using its full  path  CREATING  directories  as  needed.   If the
  209.    archive type is Lharc the switch  used  is  "-r"  or  "-x".  If Zoo the
  210.    switch is ".//"   See    the    archiver's    documentation   for  more
  211.    information.
  212.  
  213.  
  214.        WARNING          WARNING             WARNING             WARNING
  215.  
  216.    When ADDING or EXTRACTING files LAZi will ALWAYS  OVERWRITE an existing
  217.    file with the same filename in the DESTINATION directory!!!   Read your
  218.    archivers  documentation  on  UPDATE.  LAZi will only MODIFY files  and
  219.    archives  in the destination directory.  If the archive is not  in  the
  220.    destination directory  LAZi  WILL  COPY  IT  THERE.    LAZi also ALWAYS
  221.    retrieves files and  archives  to MODIFY from the SOURCE directory.  IF
  222.    you MODIFY (add, update,  delete)  files  in AN ARCHIVE and LEAVE IT IN
  223.    THE  DESTINATION  DIRECTORY then decide  to  MODIFY  the  SAME  archive
  224.    WITHOUT first MOVING it back into  the  SOURCE  DIRECTORY  you  will be
  225.    MODIFYING the ORIGINAL UNMODIFIED archive.  i.e.    You  will lose your
  226.    previous work.  Remember LAZi first copies the  archive from the source
  227.    then modifies it.  LAZi has a MOVE button  (explained  in Option Window
  228.    section) that copies the current archive (or any one you  choose)  from
  229.    the destination to the source then deletes the copy in the destination.
  230.    USE  IT!    If your source directory and destination are the same,  the
  231.    point is moot!
  232.  
  233.    OPTIONS will take you to the Options Window.
  234.  
  235.    EXTRACT ALL does what it says.  If you click on an archive's  entry  in
  236.    the list display and click EXTRACT ALL, LAZi will extract all the files
  237.    in the  archive  and  place them in the destination directory then show
  238.    the destination directory contents in the list display.  If 'pathnames'
  239.    is set LAZi will extract to pathnames.
  240.  
  241.    TEST will test the archive  and  show  you  the  results  in  the  list
  242.    display.  (not implemented with "arc" archives)
  243.  
  244. @ Options Window - the heart of LAZi
  245.  
  246.    ** Clicking the Right Mouse Button will return you to the Main Window **
  247.  
  248.        WARNING          WARNING             WARNING             WARNING
  249.  
  250.    When ADDING or EXTRACTING files LAZi will ALWAYS  OVERWRITE an existing
  251.    file with the same filename in the DESTINATION directory!!!   Read your
  252.    archivers  documentation  on  UPDATE.  LAZi will only MODIFY files  and
  253.    archives  in the destination directory.  If the archive is not  in  the
  254.    destination directory  LAZi  WILL  COPY  IT  THERE.    LAZi also ALWAYS
  255.    retrieves files and  archives  to MODIFY from the SOURCE directory.  IF
  256.    you modify (add, update,  delete)  files  in an archive and LEAVE IT IN
  257.    THE  DESTINATION  DIRECTORY then decide  to  MODIFY  the  SAME  archive
  258.    WITHOUT first MOVING it back into  the  SOURCE  DIRECTORY  you  will be
  259.    MODIFYING the ORIGINAL UNMODIFIED archive.  i.e.    You  will lose your
  260.    previous work.   Remember LAZi first copies the archive from the source
  261.    then modifies it.    LAZi  has  a  MOVE  button that copies the current
  262.    archive (or any one you choose) from the destination to the source then
  263.    deletes the copy in the destination.  USE IT!  If your source directory
  264.    and destination are the same, the  point  is moot!  The Archive Options
  265.    window has two list displays and various buttons and gadgets that allow
  266.    you to create and modify archives.  When  first opened it will show the
  267.    current source directory in the UPPER display.  The  "PICK" button will
  268.    be in its DEACTIVATED state.
  269.  
  270. *** SRC: button and string gadget
  271.  
  272.    Same as Main - listing in UPPER display only
  273.  
  274. *** PARENT button
  275.  
  276.    Same as Main
  277.    
  278. *** "«" button (default source)
  279.    
  280.    Will reset the source directory to its default and display its contents
  281.    in the upper display.  If there is  no  stored  default,  the directory
  282.    from which LAZi was started will be used as  the  default source.  This
  283.    does not affect the destination directory. (late addition)
  284.  
  285. *** HELP!
  286.  
  287.    Same as Main
  288.  
  289. *** Available Memory
  290.  
  291.    Same as Main
  292.  
  293. *** ICONIFY!
  294.  
  295.    Same as Main
  296.  
  297. *** UPPER DISPLAY
  298.  
  299.    The UPPER display functions ALMOST exactly like the list display in the
  300.    Main Window.  I say almost because there are two  buttons  to the right
  301.    of the UPPER display, one of which modifies the UPPER display's  usage.
  302.    Also,  double  clicking  on  an ASCII file in the DESTINATION directory
  303.    will allow  you to read the file in the LAZiViewer (if you want to read
  304.    a file from  the  source read from the main window).    There  is  also
  305.    Major Exception when SELECTING FILES IN  AN ARCHIVE.  I will start with
  306.    the "Pick" button.  
  307.     
  308.    Pick:
  309.         The Pick button is a  toggle  button, meaning that if activated it
  310.         will stay activated until you deactivate it by clicking it again.  
  311.     
  312.         If ACTIVATED;  the UPPER  display  is  in  select  or  pick  mode.
  313.         Clicking an entry in the UPPER  display  will duplicate that entry
  314.         in the LOWER display.  The entry will be SELECTED.
  315.     
  316.         If DEACTIVATED;  the UPPER display functions similarly to the list
  317.         display in  the  main  window  with the added ability to read text
  318.         files from the  destination directory.  
  319.    a:  
  320.         This button stands for 'ALL'.  When  clicked  ALL entries shown in
  321.         the UPPER display will become SELECTED.  They  will  be  listed in
  322.         the LOWER display.
  323.    X:
  324.         This  is  the  'EXCHANGE'  button.  When click the current  source
  325.         directory becomes the current  destination  and vice versa.  (late
  326.         addition.)
  327.  
  328.            SELECTING FILES IN AN EXISTING ARCHIVE FOR MODIFICATION
  329.           
  330.    To SELECT files for EXTRACTION or DELETION in an ARCHIVE;  double click
  331.    on the archive's name in the UPPER  display  (pick/select mode OFF!) to
  332.    get the archive's listing, then enter PICK mode  and click on the files
  333.    you want to EXTRACT or DELETE.  They will  be  become SELECTED and will
  334.    be shown in the LOWER display.
  335.  
  336.  
  337. *** LOWER DISPLAY
  338.  
  339.    The LOWER display displays the SELECTED files from the SOURCE directory
  340.    or ARCHIVE that you  want  to  operate  on  when  using  the  "Options"
  341.    buttons.  Clicking on an  entry  in  the  LOWER  display UNSELECTS that
  342.    entry and removes it from the display.  The lower display has a special
  343.    button attached to it;
  344.  
  345.    Clear:  
  346.     
  347.          This button will erase all SELECTED  files  shown  in  the  lower
  348.          display,  erase  the current archive name shown  in  the  archive
  349.          string gadget, and reset the "Pick" button.
  350.         
  351.  
  352. *** Archive Type
  353.  
  354.    Informs LAZi of the type of archive you want to work with.
  355.  
  356. *** Pathnames
  357.  
  358.    Same as Main window.  It will inherit its setting from the main window.
  359.  
  360. *** DST DIR button and string gadget
  361.  
  362.    Clicking  on  this button will list the destination  directory  in  the
  363.    UPPER display.  You must use this button when  you  want to VIEW a file
  364.    while  using  the  options  window.    The  TITLE/DRAG/STATUS  bar will
  365.    indicate that  the  display  is  the destination directory.  Entering a
  366.    valid  directory in  the  string  gadget  will  make  it  your  current
  367.    destination directory.
  368.  
  369. *** ARCHIVE string gadget
  370.  
  371.    This gadget will show  the  current archive if you double clicked on an
  372.    archive's name in the UPPER  display  or allow you to select an archive
  373.    to work with IF IT IS  IN  YOUR  SOURCE  DIRECTORY.   If this gadget is
  374.    blank you cannot modify an archive.
  375.  
  376. *** m (move)
  377.  
  378.    After  modifying  an  archive,  which  will  be   in  your  destination
  379.    directory,  clicking this  button  will  MOVE  the  archive  from   the
  380.    DESTINATION directory to the SOURCE.  i.e.  it will copy the archive to
  381.    the  source  directory  then  DELETE  the  archive  in the  destination
  382.    directory.  IF SRC = DST, LAZi will NOT allow a move.
  383.  
  384. *** OPTIONS
  385.  
  386.    ADD adds the selected files to the chosen archive or  CREATE an archive
  387.    is one is not found.  Follow the prompts in the  TITLE/DRAG/STATUS bar.
  388.  
  389.    DELETE  deletes files from the archive shown in the UPPER display.   To
  390.    SELECT  files  for deleting;  double click on the archive's name in the
  391.    UPPER display,  enter  PICK  mode  and  select  the  files.  Follow the
  392.    prompts in the TITLE/DRAG/STATUS bar.  
  393.  
  394.    EXTRACT extracts the  files  you  selected, using the above procedures,
  395.    from your chosen archive  to  the  DESTINATION  directory.   Follow the
  396.    prompts in the TITLE/DRAG/STATUS bar.  
  397.  
  398.    UPDATE adds selected files if  they are not contained in the archive or
  399.    are newer than files existing in  the archive.  Very similar to the ADD
  400.    command.  Follow the prompts in the  TITLE/DRAG/STATUS  bar.    
  401.  
  402. *** PERFORM!
  403.  
  404.    When the proper files (archive or directory), archive, and archive type
  405.    have been set  and/or  selected,  Perform!    will  start  your  chosen
  406.    operation.  Once again,  follow  the  prompts  in the TITLE/DRAG/STATUS
  407.    bar.
  408.  
  409.  
  410.  
  411.                                     HOWTO
  412.    
  413.    
  414.    After  a  little  use  you  will  probably find  short  cuts  to  these
  415.    procedures...  ;^) Remember that MOVE ("m") will overwrite  an existing
  416.    archive in the SOURCE directory AND delete the copy in  the DESTINATION
  417.    directory.  I suggest using different directories as  your  Source  and
  418.    Destination but the choice is yours.  LAZi will not  allow  you to MOVE
  419.    an archive when SRC = DST.
  420.    
  421.    
  422.    ADDING TO  AN ARCHIVE:  
  423.    
  424.    Make sure the files you want to add  are  in  your source directory and
  425.    listed in the upper list display.  Click the  PICK button.  If you want
  426.    to select individual files click on the files you want  to ADD.  If you
  427.    want  to  add all files in the source directory click the  "a"  button.
  428.    Your selections will be shown in the lower display.  Click in the lower
  429.    display  to  remove  a  selection  or  the "Clear" button to remove all
  430.    selections.   Click  on  the  archive  utility  you  want to use in the
  431.    ARCHIVE TYPE section.   Enter the archive's name in the "archive string
  432.    gadget".  Click add.    If  all is ok, click "Perform!".  When finished
  433.    LAZi will list your modified archive in the LOWER display.  REMEMBER TO
  434.    MOVE THE MODIFIED ARCHIVE, USING  THE  "m" BUTTON, FROM THE DESTINATION
  435.    TO SOURCE BEFORE CONTINUING!!!  I do this everytime (well, most  of the
  436.    time...) I create  or  modify an archive to prevent "accidents".  Press
  437.    CLEAR before continuing  to  clear  the  lower  display  of the archive
  438.    listing and reset buttons.    If there is a problem it will be noted in
  439.    the TITLE/DRAG/STATUS bar.  
  440.    
  441.    CREATING A NEW ARCHIVE:
  442.    
  443.    Use the same procedures noted above.
  444.    
  445.    DELETING FROM AN ARCHIVE:
  446.    
  447.    Double on the archive's name in the listing of the SOURCE in  the upper
  448.    display.  The  upper  display will  show the archives contents.   Click
  449.    PICK.  Select the files in the archive listing that you want to delete.
  450.    Click on the archive type.  Click DELETE.    Click Perform!  Click "m".
  451.    Click clear.
  452.    
  453.    EXTRACTING FROM AN ARCHIVE:
  454.    
  455.    Use  the  same  procedures  as  above to select the files you  want  to
  456.    extract.   If  you  want  to  extract  them  all, use the Main window's
  457.    EXTRACT ALL function.    Click  EXTRACT.    Click  Perform!   The UPPER
  458.    display will show a  listing of the DESTINATION directory.  If you want
  459.    to read a file in  the  DESTINATION  listing  double  click on the file
  460.    name.  Click clear.  Click SRC:  to return the upper display.
  461.    
  462.    UPDATING AN ARCHIVE:
  463.    
  464.    Use the same procedures as ADD  or  Create.   If the file exists in the
  465.    archive and is NEWER than a SELECTED  file  it will not be updated.  If
  466.    the file does not exist in the archive or is NEWER than an existing one
  467.    it will be added.
  468.    
  469.    
  470.    LAZiViewer
  471.    
  472.    I think a simple viewer should  show  as much text as possible thus the
  473.    menus rather than buttons.  If you  click in the text display (a cursor
  474.    becomes visible) you can use the cursor keys  to  navigate  your  text.
  475.    Also a quick double click while using the scroll  gadgets will speed up
  476.    scrolling.
  477.    
  478.    Hope LAZi is useful to you.
  479.    
  480.    
  481.                                 Mark W. Davis
  482.                                 P.O. Box 84321
  483.                                 Seattle, WA.  98112
  484.                                 mwd@cup.portal.com